---
title: "dimensions"
sidebarTitle: "dimensions"
---

`dimensions: [list of SQL expressions]`

The test will group the results by a given column / columns / valid select sql expression.
Under `dimensions` you can configure the group by expression.

Using this param segments the tested data per dimension, and each dimension is monitored separately.

For example - 
A `column_anomalies` test monitoring for `null_rate` with `dimensions` configured will monitor the 
`null_rate` of values in the column, grouped by dimension, and will fail if in a specific dimension there is an anomaly in `null_rate`.
It is best to configure low-cardinality fields as `dimensions`.

- _Default: None_
- _Relevant tests: `dimension_anomalies`, `column_anomalies`, `all_columns_anomalies`_
- _Configuration level: test_

<RequestExample>

```yml test
models:
  - name: model_name
    config:
      elementary:
        timestamp_column: updated_at
    tests:
      - elementary.dimension_anomalies:
          dimensions:
            - device_os
            - device_browser
```

</RequestExample>
